###User Defined Function###
_FTP_ProgressDownload

###Description###
Ldt eine Datei im Binrmodus herunter und zeigt entweder ein Fortschrittsfenster an oder ruft dazu eine Benutzerfunktion auf

###Syntax###
#include <FTPEx.au3>
_FTP_ProgressDownload ( $hFTPSession, $sLocalFile, $sRemoteFile [, $sFunctionToCall = ""] )


###Parameters###
@@ParamTable@@
$hFTPSession
	FTP-Handle, wie von _FTP_Connect().
$sLocalFile
	Die lokale Zieldatei.
$sRemoteFile
	Die Quelldatei auf dem FTP-Server.
$sFunctionToCall
	[optional] Eine Funktion, die einen Fortschrittsbalken aktualisieren und auf Benutzereingaben wie Klicks auf Abbrechen oder Beenden reagieren kann. (Mehr Informationen in den Bemerkungen)
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	1
Fehler:	0 und setzt @error auf nicht null:
@error:	-1 - Lokale Datei konnte nicht erstellt werden
	-2 - Ermitteln der REmotedateigre nicht mglich
	-3 - Quelldatei konnte nicht geffnet werden
	-4 - Fehler beim Lesen der Quelldatei
	-5 - Schlieen der Quelldatei fehlgeschlagen
	-6 - Download durch Benutzerfunktion abgebrochen, deren Rckgabewert wurde zurckgegeben
	-7 - Das Schreiben der lokalen Datei fehlgeschlagen
@@End@@


###Remarks###
Informationen zu $sFunctionToCall:
   Parameter: $iPercentage - Der Fortschritt in Prozent
   Rckgabewerte: Download fortsetzen - 1
                  Download abbrechen  - 0 oder negativ
                       Diese Rckgabewerte werden dann von _FTP_ProgressDownload() zurckgegeben,
                       sodass auf verschiedene Ereignisse wie Abbruch durch Benutzer oder Beenden reagiert werden kann
   Beispiele:
                   Func _UpdateProgress($Prozent)
                      ProgressSet($Prozentt,$Prozent &"%")
                      If _IsPressed("77") Then Return 0 ; Abbruch bei F8
                      Return 1 ; bei 1 Fortsetzten
                   Endfunc

                   Func _UpdateProgress($Prozent)
                      GUICtrlSetData($ProgressBarCtrl,$Prozent)
                      Switch GUIGetMsg()
                         Case $GUI_EVENT_CLOSE
                            Return -1 ; _FTP_DownloadProgress bricht mit -1 ab, so dass das Skript danach beendet werden kann
                        Case $Btn_Cancel
                           Return 0 ; Nur abbrechen, ohne spezielle Rckgabe
                      EndSwitch
                      Return 1 ; andernfalls Download fortsetzen
                   Endfunc


###Related###


###Example###
@@IncludeExample@@ 